package com.ruoyi.system.service;

import java.util.List;
import com.ruoyi.system.domain.SysNoticeRead;
import org.apache.ibatis.annotations.Param;

/**
 * 通知公告阅读记录 服务层
 * 
 * @author ruoyi
 */
public interface ISysNoticeReadService
{
    /**
     * 查询公告阅读记录信息
     * 
     * @param id 主键ID
     * @return 阅读记录信息
     */
    public SysNoticeRead selectNoticeReadById(Long id);

    /**
     * 查询公告阅读记录列表
     * 
     * @param noticeRead 阅读记录信息
     * @return 阅读记录集合
     */
    public List<SysNoticeRead> selectNoticeReadList(SysNoticeRead noticeRead);

    /**
     * 根据公告ID查询阅读记录列表
     * 
     * @param noticeId 公告ID
     * @return 阅读记录集合
     */
    public List<SysNoticeRead> selectNoticeReadByNoticeId(Long noticeId);



    /**
     * 查询用户是否已读指定公告
     * 
     * @param noticeId 公告ID
     * @param userId 用户ID
     * @return 阅读记录
     */
    public SysNoticeRead selectNoticeReadByNoticeIdAndUserId(Long noticeId, Long userId);

    /**
     * 新增公告阅读记录
     * 
     * @param noticeRead 阅读记录信息
     * @return 结果
     */
    public int insertNoticeRead(SysNoticeRead noticeRead);

    /**
     * 修改公告阅读记录
     * 
     * @param noticeRead 阅读记录信息
     * @return 结果
     */
    public int updateNoticeRead(SysNoticeRead noticeRead);

    /**
     * 删除公告阅读记录信息
     * 
     * @param id 主键ID
     * @return 结果
     */
    public int deleteNoticeReadById(Long id);

    /**
     * 根据公告ID删除阅读记录
     * 
     * @param noticeId 公告ID
     * @return 结果
     */
    public int deleteNoticeReadByNoticeId(Long noticeId);
    
    /**
     * 批量删除公告阅读记录信息
     * 
     * @param ids 需要删除的主键ID
     * @return 结果
     */
    public int deleteNoticeReadByIds(Long[] ids);

    /**
     * 统计公告阅读情况
     * 
     * @param noticeId 公告ID
     * @return 统计结果
     */
    public SysNoticeRead selectNoticeReadStatistics(Long noticeId);

    /**
     * 标记公告为已读
     * 
     * @param noticeId 公告ID
     * @param userId 用户ID
     * @return 结果
     */
    public int markNoticeAsRead(@Param("noticeId") Long noticeId, @Param("userId") Long userId);
}
